ARIA: aria-multiline Attribut

Das aria-multiline Attribut gibt an, ob ein textbox mehrere Zeilen Eingabe akzeptiert oder nur eine einzelne Zeile.

Beschreibung

Das Standardverhalten der Enter- oder Return-Taste unterscheidet sich zwischen einzeiligen und mehrzeiligen Textfeldern. Wenn der Benutzerfokus auf einem einzeiligen <input type="text"> liegt, bewirkt ein Enter- oder Return-Tastendruck normalerweise das Absenden des Formulars.

Befindet sich der Benutzerfokus auf einem mehrzeiligen <textarea>, fügt der Tastendruck einen Zeilenumbruch ein. Nur relevant für Elemente mit der festgelegten Rolle textbox, zeigt das aria-multiline Attribut assistiven Technologien an, ob dieses Textfeld mehrere Zeilen Eingabe akzeptiert oder nur eine einzelne Zeile und setzt Erwartungen, welche Art von Daten eingegeben werden sollen und was diese Tastendrucke bewirken.

Hinweis: Wo möglich, verwenden Sie das HTML <input> oder das <textarea>, da diese eingebaute Semantik und Verhaltensweisen haben, keine ARIA-Attribute oder Skripting erfordern und über eingebaute Tastaturunterstützung verfügen.

Wenn das aria-multiline="true" gesetzt ist, bedeutet dies, dass das Textfeld-Widget Zeilenumbrüche innerhalb der Eingabe akzeptiert, ähnlich wie das HTML <textarea>. Elemente mit einer Rolle von textbox, die das Attribut nicht haben oder den Wert auf false gesetzt haben, sind einfache Textfelder.

Achten Sie auf den Fokus und Tastendrucke beim Entwerfen von Textfeldern. ARIA modifiziert nur den Accessibility-Tree und somit, wie assistive Technologie das Textfeld Ihren Benutzern präsentiert. ARIA ändert nichts an der Standardfunktion oder dem Verhalten eines Elements. Wenn semantische HTML-Elemente nicht für ihren vorgesehenen Zweck und ihre Standardfunktionalität verwendet werden, müssen Sie JavaScript verwenden, um das Verhalten und die Funktionalität zu verwalten, einschließlich der Reaktion auf Tastendruckereignisse.

Werte

true: Das Textfeld akzeptiert mehrere Zeilen Eingabe.
false: Das Textfeld akzeptiert nur eine einzelne Zeile Eingabe.

Zugehörige Schnittstellen

Element.ariaMultiLine: Die ariaMultiLine Eigenschaft, Teil der Element Schnittstelle, reflektiert den Wert des aria-multiline Attributs.
ElementInternals.ariaMultiLine: Die ariaMultiLine Eigenschaft, Teil der ElementInternals Schnittstelle, reflektiert den Wert des aria-multiline Attributs.

Zugehörige Rollen

Verwendet in Rollen:

textbox

Geerbt in Rollen:

searchbox

Spezifikationen

Specification
Accessible Rich Internet Applications (WAI-ARIA) # aria-multiline

Siehe auch

ARIA textbox Rolle
ARIA searchbox Rolle